home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / u_man / cat3 / Tcl / gets.z / gets
Encoding:
Text File  |  1998-10-30  |  2.1 KB  |  67 lines
  1.  
  2.  
  3.  
  4. ggggeeeettttssss((((3333TTTTccccllll))))                                                          ggggeeeettttssss((((3333TTTTccccllll))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      gets - Read a line from a file
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ggggeeeettttssss _f_i_l_e_I_d ?_v_a_r_N_a_m_e?
  13.  
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      This command reads the next line from the file given by _f_i_l_e_I_d and
  17.      discards the terminating newline character.  If _v_a_r_N_a_m_e is specified then
  18.      the line is placed in the variable by that name and the return value is a
  19.      count of the number of characters read (not including the newline).  If
  20.      the end of the file is reached before reading any characters then -1 is
  21.      returned and _v_a_r_N_a_m_e is set to an empty string.  If _v_a_r_N_a_m_e is not
  22.      specified then the return value will be the line (minus the newline
  23.      character) or an empty string if the end of the file is reached before
  24.      reading any characters.  An empty string will also be returned if a line
  25.      contains no characters except the newline, so eeeeooooffff may have to be used to
  26.      determine what really happened.  If the last character in the file is not
  27.      a newline character then ggggeeeettttssss behaves as if there were an additional
  28.      newline character at the end of the file.  _F_i_l_e_I_d must be ssssttttddddiiiinnnn or the
  29.      return value from a previous call to ooooppppeeeennnn; it must refer to a file that
  30.      was opened for reading.  Any existing end-of-file or error condition on  |
  31.      the file is cleared at the beginning of the ggggeeeettttssss command.
  32.  
  33.  
  34. KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
  35.      file, line, read
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.